home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 January: Mac OS SDK / Dev.CD Jan 96 SDK / Dev.CD Jan 96 SDK1.toast / Development Kits (Disc 1) / AOCE / Development Tools / Interfaces / PInterfaces / OCETemplates.p < prev   
Encoding:
Text File  |  1993-11-10  |  71.1 KB  |  1,716 lines  |  [TEXT/MPS ]
  1. {***********************************************************
  2.  
  3. Created: Tuesday, August 17, 1993 4:37:24 PM
  4.  OCETemplates.p
  5.  Pascal Interface to the Macintosh Libraries
  6.  
  7.   Copyright Apple Computer, Inc. 1990-1993
  8.   All rights reserved
  9.  
  10. ***********************************************************}
  11.  
  12.  
  13. {$IFC UNDEFINED UsingIncludes}
  14. {$SETC UsingIncludes:= 0}
  15. {$ENDC}
  16.  
  17. {$IFC NOT UsingIncludes}
  18.     UNIT OCETemplates;
  19.     INTERFACE
  20. {$ENDC}
  21.  
  22. {$IFC UNDEFINED UsingOCETemplates}
  23. {$SETC UsingOCETemplates:= 1}
  24.  
  25. {$I+}
  26. {$SETC OCETemplatesIncludes:= UsingIncludes}
  27. {$SETC UsingIncludes:= 1}
  28.  
  29.  
  30. {$IFC UNDEFINED UsingTypes}
  31. {$I $$Shell(PInterfaces)Types.p}
  32. {$ENDC}
  33.  
  34. {$IFC UNDEFINED UsingEvents}
  35. {$I $$Shell(PInterfaces)Events.p}
  36. {$ENDC}
  37.  
  38. {$IFC UNDEFINED UsingOCE}
  39. {$I OCE.p}
  40. {$ENDC}
  41.  
  42. {$IFC UNDEFINED UsingOCEStandardMail}
  43. {$I OCEStandardMail.p}
  44. {$ENDC}
  45.  
  46. {$SETC UsingIncludes:= OCETemplatesIncludes}
  47.  
  48.  
  49.  
  50. {**********************************************************************************************}
  51. {******************************** Template Resource Constants: ********************************}
  52. {**********************************************************************************************}
  53.  
  54.  
  55. { Current versions of all the different template types: }
  56.  
  57. CONST
  58. kDETAspectVersion        = -976;
  59. kDETInfoPageVersion        = -976;
  60. kDETKillerVersion        = -976;
  61. kDETForwarderVersion    = -976;
  62. kDETFileTypeVersion        = -976;
  63.  
  64.  
  65. { "Normal" separation for template IDs within the file (this is just a suggestion; you can use whatever
  66.     separation you like, so long as two separate templates don't have overlapping resources): }
  67. kDETIDSep = 250;
  68.  
  69. { A few predefined base IDs (again, just suggestions): }
  70. kDETFirstID        = (1000);
  71. kDETSecondID    = (1000+kDETIDSep);
  72. kDETThirdID        = (1000+2*kDETIDSep);
  73. kDETFourthID    = (1000+3*kDETIDSep);
  74. kDETFifthID        = (1000+4*kDETIDSep);
  75.  
  76. {    Templates consist of a set of associated resources, at constant offsets from a "base ID" set by the
  77.     signature resource of the template. In the case of aspect templates, most of the resources in the
  78.     template are accessible from the template as property default values. The property number is the same
  79.     as the offset from the base ID of the resource. In describing the resources which make up templates,
  80.     we give the type, the offset, and a description. For aspect templates, the offset is also the property #. }
  81.     
  82. {    All templates include the following resource fork resources:
  83.  
  84.      Type    Offset                        Description
  85.      ----    ------                        -----------
  86.     'rstr'    kDETTemplateName            Contains the name of the template
  87.  
  88. }
  89.  
  90. kDETTemplateName = 0;
  91.  
  92. {    Aspects, info-pages, and forwarders include the following as well:
  93.  
  94.      Type    Offset                        Description
  95.      ----    ------                        -----------
  96.     'rstr'    kDETRecordType                Contains the type of record this applies to
  97.     'rstr'    kDETAttributeType            Contains the type of attribute this applies to
  98.     'detn'    kDETAttributeValueTag        Contains the tag of the attribute values this applies to
  99.  
  100. }
  101.  
  102. kDETRecordType                = 1;
  103. kDETAttributeType            = 2;
  104. kDETAttributeValueTag        = 3;
  105.  
  106.  
  107. { ************************************ Aspects }
  108.  
  109. {    In the case of aspects, property numbers and resource id offsets are the same. Therefore, some of the following
  110.     defines are used for resource offsets, some are used for dynamically generated properties, and some are used for
  111.     both (i.e., properties which may be dynamically generated, but if they aren't, then they're taken from the
  112.     resource). Resource types are given in all cases below; even if there is no actual resource (for example in
  113.     the case of kDETAspectName), it indicates the type for the dynamically generated property. A resource type of
  114.     'rstr' corresponds to a property type of kDETPrTypeString; type 'detn' corresponds to kDETPrTypeNumber; and
  115.     'detb' corresponds to kDETPrTypeBinary.
  116.  
  117.      Type    Offset                        Description
  118.      ----    ------                        -----------
  119.     'deta'    0                            Identifies the type of resource
  120.     'detc'    kDETCode                    Is the code resource, if any is used
  121.     'ICN#'    kDETAspectMainBitmap
  122.     'icl8'    kDETAspectMainBitmap
  123.     'icl4'    kDETAspectMainBitmap
  124.     'ics#'    kDETAspectMainBitmap
  125.     'ics8'    kDETAspectMainBitmap
  126.     'ics4'    kDETAspectMainBitmap
  127.     'sicn'    kDETAspectMainBitmap        Is the icon suite to display for this item type (main aspect only)
  128.     'rstr'    kDETAspectName                Contains the name of the item (attribute main aspect only)
  129.     'rst#'    kDETAspectCategory            Contains the internal categories for the record type (main aspect only)
  130.     'rst#'    kDETAspectExternalCategory    Contains the external (user-visible) names which correspond to the categories in
  131.                                         kDETAspectCategory; if this resource is not present, external names are taken from
  132.                                         another template; if no other template provides an external name for a given internal
  133.                                         category, the internal name is used as the external name (main aspect only)
  134.     'rstr'    kDETAspectKind                Is the item kind to display (main aspect only)
  135.     'detn'    kDETAspectGender            Is the gender of this kind of object for internationalization (main aspect only)
  136.     'rstr'    kDETAspectWhatIs            Is the string for balloon help when item is in sublist (main aspect only)
  137.     'rstr'    kDETAspectAliasKind            Is the item kind to display for aliases to this type of item (main aspect only)
  138.     'detn'    kDETAspectAliasGender        Is the gender of an alias to this kind of object for internationalization (main aspect only)
  139.     'rstr'    kDETAspectAliasWhatIs        Is the string for balloon help when an alias to the item is in sublist (main aspect only)
  140.     'rst#'    kDETAspectBalloons            Is a list of strings for balloon help; for each item in an info-page, it's
  141.                                         property # times 2 is used as an index into this array; if the item is not editable,
  142.                                         then the property # times 2 plus 1 is used
  143.     'rstr'    kDETAspectNewMenuName        Is the string to be used for the user to select new item creation; for records, the
  144.                                         string is used as a menu entry in the Catalogs menu; for attributes, the string
  145.                                         is used in a selection dialog invoked by an "Add..." button
  146.     'rstr'    kDETAspectNewEntryName        Is the name to be used for new records (with a digit appended if not unique)
  147.     'detb'    kDETAspectNewValue            Is the value to use when creating a new attribute value; the first four bytes
  148.                                         is the tag; the rest is the attribute value contents
  149.     'detn'    kDETAspectSublistOpenOnNew    If true (non-zero), automatically open newly created entries (property can be set
  150.                                         from a code resource, or via a default value in a resource)
  151.     'dett'    kDETAspectLookup            Is the attribute-to-property translation table
  152.     'rstr'    kDETAspectDragInString        Is a string describing the action of dragging into this aspect (if any)
  153.     'rstr'    kDETAspectDragInVerb        Is a single, short word that's the verb of the action (like "add" or "drop"; if
  154.                                         there's any doubt, use "OK")
  155.     'rstr'    kDETAspectDragInSummary        Is a short phrase that describes the action, suitable to be included in a selection list
  156.     'rst#'    kDETAspectRecordDragIn        Is a list of type pairs; in each pair, the first is the type of a record which
  157.                                         can be dragged into this aspect, and the second is the attribute type to store
  158.                                         the reference in
  159.     'rst#'    kDETAspectRecordCatDragIn    Is a list of category/attribute type pairs; in each pair, the first is the
  160.                                         category of records which can be dragged in, and the second is the type of
  161.                                         attribute to place the alias in
  162.     'rst#'    kDETAspectAttrDragIn        Is a list of type triples; in each triple, the first is the record type which can be
  163.                                         dragged from (or "" for any), the second is the attribute type which can be dragged
  164.                                         in, and the third is the attribute type to store the new attribute in
  165.     'rst#'    kDETAspectDragOut            Is a list of attribute types which can be dragged out of this aspect (an 'rst#'
  166.                                         resource with no entries means nothing can be dragged out; no 'rst#' resource means
  167.                                         everything can be dragged out)
  168.     'detm'    kDETAspectViewMenu            Is a table to fill in the view menu from
  169.     'detp'    kDETAspectReverseSort        Is a table listing which properties to sort in reverse order
  170.     'detw'    kDETAspectInfoPageCustomWindow    Is a specification of a custom window size/placement & whether to use the
  171.                                             page-selector (main aspect only)
  172.     'detv'    kDETAspectInfoPageCustomWindow    Is a view list which is common to all info-pages (main aspect only)
  173. }
  174.  
  175. kDETAspectCode                    =  4;
  176. kDETAspectMainBitmap            =  5;
  177. kDETAspectName                    =  6;
  178. kDETAspectCategory                =  7;
  179. kDETAspectExternalCategory        =  8;
  180. kDETAspectKind                    =  9;
  181. kDETAspectGender                = 10;
  182. kDETAspectWhatIs                = 11;
  183. kDETAspectAliasKind                = 12;
  184. kDETAspectAliasGender            = 13;
  185. kDETAspectAliasWhatIs            = 14;
  186. kDETAspectBalloons                = 15;
  187. kDETAspectNewMenuName            = 16;
  188. kDETAspectNewEntryName            = 17;
  189. kDETAspectNewValue                = 18;
  190. kDETAspectSublistOpenOnNew        = 19;
  191. kDETAspectLookup                = 20;
  192. kDETAspectDragInString            = 21;
  193. kDETAspectDragInVerb            = 22;
  194. kDETAspectDragInSummary            = 23;
  195. kDETAspectRecordDragIn            = 24;
  196. kDETAspectRecordCatDragIn        = 25;
  197. kDETAspectAttrDragIn            = 26;
  198. kDETAspectAttrDragOut            = 27;
  199. kDETAspectViewMenu                = 28;
  200. kDETAspectReverseSort            = 29;
  201. kDETAspectInfoPageCustomWindow    = 30;
  202.  
  203.  
  204. { Properties: }
  205.  
  206. kDETNoProperty                = -1;
  207.  
  208. { Each aspect has 250 attribute properties in this range: }
  209. kDETFirstLocalProperty        = 0;
  210. kDETLastLocalProperty         = (kDETFirstLocalProperty+249);
  211.  
  212. { Developers should use property numbers starting at this point: }
  213. kDETFirstDevProperty        = 40;
  214.  
  215. { The following range provides constant numeric properties for use in patterns and comparisons (constant n is
  216.   given by kDETFirstConstantProperty+n): }
  217. kDETFirstConstantProperty    = 250;
  218. kDETLastConstantProperty    = (kDETFirstConstantProperty+249);
  219.  
  220. { To convert a number into a constant property, add this: }
  221. kDETConstantProperty        = kDETFirstConstantProperty;
  222.  
  223. kDETZeroProperty            = (kDETConstantProperty+0);
  224. kDETOneProperty                = (kDETConstantProperty+1);
  225. kDETFalseProperty            = (kDETConstantProperty+0);
  226. kDETTrueProperty            = (kDETConstantProperty+1);
  227.  
  228. { The following apply to records, attributes, or aliases; they are the name and kind, as they appear in icon lists: }
  229. kDETPrName                     = 3050;
  230. kDETPrKind                     = 3051;
  231.  
  232. { Access mask properties: }
  233. kDETDNodeAccessMask            = 25825;    { The DNode access mask }
  234. kDETRecordAccessMask        = 25826;    { The record access mask }
  235. kDETAttributeAccessMask        = 25827;    { The attribute access mask }
  236. kDETPrimaryMaskByBit        = 25828;    { A set of sixteen properties to access all bits of the primary mask }
  237.  
  238. { See AOCE documentation for details definitions of each of these bits: }
  239.  
  240. kDETPrimarySeeMask            = kDETPrimaryMaskByBit;
  241. kDETPrimaryAddMask            = (kDETPrimaryMaskByBit+1);
  242. kDETPrimaryDeleteMask        = (kDETPrimaryMaskByBit+2);
  243. kDETPrimaryChangeMask        = (kDETPrimaryMaskByBit+3);
  244. kDETPrimaryRenameMask        = (kDETPrimaryMaskByBit+4);
  245. kDETPrimaryChangePrivsMask    = (kDETPrimaryMaskByBit+5);
  246. kDETPrimaryTopMaskBit        = (kDETPrimaryMaskByBit+15);
  247.  
  248. { The following property is zero until we've completed the first catalog lookup; from then on it's 1 }
  249. kDETPastFirstLookup            = 26550;
  250.  
  251. { The following property is the page number; issuing a property command with this property will flip info-pages }
  252. kDETInfoPageNumber            = 27050;
  253.  
  254. { The value of the following properties contains the template number of the targeted aspect's template, and the
  255.    currently open info-page (if any). These values can be used with kDETAspectTemplate and kDETInfoPageTemplate
  256.    target selectors. }
  257. kDETAspectTemplateNumber    = 26551;
  258. kDETInfoPageTemplateNumber    = 26552;
  259.  
  260. { Properties for property commands to deal with sublist items: }
  261. kDETOpenSelectedItems        = 26553;    { Open selected sublist items }
  262. kDETAddNewItem                = 26554;    { Add new sublist item }
  263. kDETRemoveSelectedItems        = 26555;    { Remove selected sublist items }
  264.  
  265. { Property types are used to specify types of properties and conversions between types (zero and negative numbers
  266.    are reserved for Apple; developer code resources can use positive numbers): }
  267. kDETPrTypeNumber            = -1;    { A number }
  268. kDETPrTypeString            = -2;    { A string }
  269. kDETPrTypeBinary            = -3;    { A binary block }
  270.  
  271. { Rez-compatible tag definitions (•••these are the same as in OCE.h, but they're enums there and can't be rezed•••) }
  272. {
  273. #ifdef REZ
  274. #define typeRString            'rstr'
  275. #define typePackedDSSpec    'dspc'
  276. #define typeBinary            'bnry'
  277. #endif
  278. }
  279.  
  280.  
  281. { ************************************ Info-pages }
  282.  
  283. { Info-pages include the following as well:
  284.  
  285.      Type    Offset                        Description
  286.      ----    ------                        -----------
  287.     'deti'    0                            Identifies the type of resource; see below for details on the contents
  288.     'rstr'    kDETInfoPageName            Is the name of the view to use in the page selection pop-up
  289.     'rstr'    kDETInfoPageMainViewAspect    Is the name of the aspect to use with the main page view
  290.     'rstr'    kDETInfoPageMenuName        Is the name of the catalogs menu ("Catalogs" if not present)
  291.     'detm'    kDETInfoPageMenuEntries        Are menu entries to go in the Catalogs menu
  292.  
  293. }
  294.  
  295. kDETInfoPageName            = 4;
  296. kDETInfoPageMainViewAspect    = 5;
  297. kDETInfoPageMenuName        = 6;
  298. kDETInfoPageMenuEntries        = 7;
  299.  
  300.  
  301. { ************************************ Views }
  302.  
  303. { Flags: }
  304.  
  305. kDETNoFlags                        = $0000;  {0}
  306. kDETEnabled                        = $0001;  {1 << 0}    { Main view (non-sublist) field enabled }
  307.  
  308. { The following flags make sense for items in a sublist only }
  309. kDETHilightIfSelected            = $0001;  {1 << 0}    { Hilight view when entry is selected }
  310.  
  311. { The following flags make sense for text views only }
  312. kDETNumericOnly                    = $0008;  {1 << 3}    { Only allow the user to enter digits }
  313. kDETMultiLine                    = $0010;  {1 << 4}    { Allow multiple lines in view }
  314. kDETDynamicSize                    = $0200;  {1 << 9}    { Don't draw box around text until user clicks in it, then auto-size it }
  315. kDETAllowNoColons                = $0400;  {1 << 10}    { Don't allow the user to enter colons (convert ":"s to "-"s) }
  316.  
  317. { The following flags are used for pop-up menus only }
  318. kDETPopupDynamicSize            = $0100;  {1 << 8}    { Automatically resize pop-up based on contents }
  319.  
  320. { The following flags are used for EditPicture views only }
  321. kDETScaleToView                    = $0100;  {1 << 8}    { Scale picture to view bounds rather than cropping }
  322.  
  323. {    Sizes for icons }
  324. kDETLargeIcon        = 0;
  325. kDETSmallIcon        = 1;
  326. kDETMiniIcon        = 2;
  327.  
  328. { Stolen from TextEdit.h }
  329. kDETLeft            = 0;
  330. kDETCenter            = 1;
  331. kDETRight            = -1;
  332. kDETForceLeft        = -2;
  333.  
  334. { Flags for use within Box view type attributes - these are distinct from the flags above }
  335.  
  336. kDETUnused                    = 0;
  337. kDETBoxTakesContentClicks    = $0001;  {1 << 0}
  338. kDETBoxIsRounded            = $0002;  {1 << 1}
  339. kDETBoxIsGrayed                = $0004;  {1 << 2}
  340. kDETBoxIsInvisible            = $0008;  {1 << 3}
  341.  
  342. { The common font info }
  343.  
  344. kDETApplicationFont            =  1;
  345. kDETApplicationFontSize        =  9;
  346. kDETAppFontLineHeight        = 12;
  347.  
  348. kDETSystemFont                =  0;
  349. kDETSystemFontSize            = 12;
  350. kDETSystemFontLineHeight    = 16;
  351.  
  352. kDETDefaultFont                =  1;
  353. kDETDefaultFontSize            =  9;
  354. kDETDefaultFontLineHeight    = 12;
  355.  
  356. { These were taken from QuickDraw.h (where they're enums and therefore unusable in resource definitions): }
  357. kDETNormal        = 0;
  358. kDETBold        = 1;
  359. kDETItalic        = 2;
  360. kDETUnderline    = 4;
  361. kDETOutline        = 8;
  362. kDETShadow        = $10;
  363. kDETCondense    = $20;
  364. kDETExtend        = $40;
  365.  
  366. kDETIconStyle                   = -3;    { Normal text style for regular sublist entries, italic text style for aliases }
  367.  
  368. { Views menu: }
  369.  
  370. kDETChangeViewCommand        = 'view';    { Change the view; used especially in StaticCommandTextFromView sublist headers }
  371.  
  372.  
  373. { Info-page window sizes: }
  374.  
  375. { Default record info-pages: }
  376. kDETRecordInfoWindHeight        = 228;
  377. kDETRecordInfoWindWidth            = 400;
  378.  
  379. { Default attribute info-pages: }
  380. kDETAttributeInfoWindHeight        = 250;
  381. kDETAttributeInfoWindWidth        = 230;
  382.  
  383. { Page identifying icon (for default info-page layout): }
  384. kDETSubpageIconTop        = 8;
  385. kDETSubpageIconLeft        = 8;
  386. kDETSubpageIconBottom    = (kDETSubpageIconTop+32);
  387. kDETSubpageIconRight    = (kDETSubpageIconLeft+32);
  388. (* #define kDETSubpageIconRect        = (kDETSubpageIconTop, kDETSubpageIconLeft, kDETSubpageIconBottom, kDETSubpageIconRight) *)
  389.  
  390. { The following rectangle can be used in a 'deti' with no sublist: }
  391. (* #define kDETNoSublistRect        {0, 0, 0, 0} *)
  392.  
  393.  
  394.  
  395. { ************************************ Killers }
  396.  
  397. { Killers include the following as well:
  398.  
  399.      Type    Offset                        Description
  400.      ----    ------                        -----------
  401.     'detk'    0                            Identifies the type of resource; see below for details on the contents
  402.     'rst#'    kDETKillerName                Contains a list of template names to be killed
  403.  
  404. }
  405.  
  406. kDETKillerName = 1;
  407.  
  408.  
  409. { ************************************ Forwarders }
  410.  
  411. { Forwarders include the following as well:
  412.  
  413.      Type    Offset                        Description
  414.      ----    ------                        -----------
  415.     'detf'    0                            Identifies the type of resource; see below for details on the contents
  416.     'rst#'    kDETForwarderTemplateNames    Contains a list of names of templates to forward to
  417.  
  418. }
  419.  
  420. kDETForwarderTemplateNames    = 4;
  421.  
  422.  
  423.  
  424. {*********************************************************************************}
  425. {******************************** Categories: ************************************}
  426. {*********************************************************************************}
  427.  
  428. { Internal category names: }
  429.  
  430. kDETCategoryAllItems        = 'aoce All Items';            { Everything in or out of a category }
  431. kDETCategoryAddressItems    = 'aoce Address Items';        { Anything that can be used to address something }
  432. kDETCategoryMisc            = 'aoce Miscellaneous';        { Things that don't deserve their own category }
  433.  
  434.  
  435.  
  436.  
  437.  
  438. {*********************************************************************************}
  439. {******************************** Code Resources: ********************************}
  440. {*********************************************************************************}
  441.  
  442. { Target specification: }
  443.  
  444. { Values of DETTargetSelector }
  445. kDETSelf = 0;                            { The "current" item }
  446. kDETSelfOtherAspect = 1;                { Another aspect of the current item }
  447. kDETParent = 2;                            { The parent (i.e., the aspect we're in the sublist of, if any) of the current item }
  448. kDETSublistItem = 3;                    { The itemNumberth item in the sublist }
  449. kDETSelectedSublistItem = 4;            { The itemNumberth selected item in the sublist }
  450. kDETDSSpec = 5;                            { The item specified by the packed DSSpec }
  451. kDETAspectTemplate = 6;                    { A specific aspect template (number itemNumber) }
  452. kDETInfoPageTemplate = 7;                { A specific info-page template (number itemNumber) }
  453. kDETHighSelector = $F000;                { Force type to be INTEGER }
  454.  
  455. TYPE
  456. DETTargetSelector = INTEGER;
  457.  
  458. DETTargetSpecification = RECORD
  459.     selector: DETTargetSelector;        { Target selection method (see above) }
  460.     aspectName: RStringPtr;                { The name of the aspect (kDETSelfOtherAspect, kDETSublistItem,
  461.                                           kDETSelectedSublistItem, kDETDSSpec); nil for main aspect or none;
  462.                                           always filled in for calls if there is an aspect, even if it's the main aspect }
  463.     itemNumber: LONGINT;                { Sublist index (kDETSublistItem & kDETSelectedSublistItem & kDETAspectTemplate);
  464.                                           1-based indexing }
  465.     dsSpec: PackedDSSpecPtr;            { DSSpec (kDETDSSpec only) }
  466.     END;
  467.  
  468.  
  469. { Code resource calls and call-backs both return an OSType:
  470.         kDETDidNotHandle (1)    = used by template to say "I didn't handle it" (for calls only)
  471.         noErr                    = function completed successfully
  472.         any error                = function failed, and here's why
  473. }
  474.  
  475. CONST
  476. kDETDidNotHandle = 1;
  477.  
  478. { Call-back functions:
  479.  
  480.         reqFunction                            Action
  481.         -----------                            ------
  482.         kDETcmdBeep                            Call SysBeep; useful for testing that a code resource's calls/call-backs are working at all
  483.  
  484.         kDETcmdBusy                            Put up watch cursor and switch processes; user events elicit a beep
  485.  
  486.         kDETcmdChangeCallFors                Change call-fors mask
  487.  
  488.         kDETcmdGetCommandSelectionCount        Get the command selection count (for calls which have a command selection list)
  489.         kDETcmdGetCommandItemN                Get command selection item n (for calls which have a command selection list)
  490.  
  491.         kDETcmdOpenDSSpec                    PackedDSSpec open (can also be done via AppleEvents -- this is a short-cut)
  492.  
  493.         kDETcmdAboutToTalk                    About to talk to user: bring us to front, disable watch cursor, etc.
  494.  
  495.         kDETcmdUnloadTemplates                Flush templates
  496.  
  497.         kDETcmdTemplateCounts                Return number of aspect and info-page templates in system
  498.  
  499.         kDETcmdGetDSSpec                    Get the PackedDSSpec for this object
  500.  
  501.         kDETcmdSublistCount                    Return the count of the sublist items
  502.         kDETcmdSelectedSublistCount            Return the count of the selected sublist items
  503.  
  504.         kDETcmdRequestSync                    Request a sync-up of the aspect with the catalog
  505.  
  506.         kDETcmdBreakAttribute                Break an attribute -- apply all applicable patterns to an attribute to generate properties
  507.  
  508.         kDETcmdGetTemplateFSSpec            Get the FSSpec of the file containing the template
  509.  
  510.         kDETcmdGetOpenEdit                    Return the property of the view being edited (or kDETNoProperty if none)
  511.         kDETcmdCloseEdit                    Close the current edit
  512.  
  513.         kDETcmdGetPropertyType                Get a property type
  514.  
  515.         kDETcmdGetPropertyNumber            Get a property, number format
  516.         kDETcmdGetPropertyRString            Get a property, RString format
  517.         kDETcmdGetPropertyBinarySize        Get a property, binary, return size
  518.         kDETcmdGetPropertyBinary            Get a property, binary format
  519.  
  520.         kDETcmdGetPropertyChanged            Get a property changed flag
  521.         kDETcmdGetPropertyEditable            Get a property editable flag
  522.  
  523.         kDETcmdSetPropertyType                Set a property type
  524.  
  525.         kDETcmdSetPropertyNumber            Set a property, number format
  526.         kDETcmdSetPropertyRString            Set a property, RString format
  527.         kDETcmdSetPropertyBinary            Set a property, binary data & size
  528.  
  529.         kDETcmdSetPropertyChanged            Set a property changed flag
  530.         kDETcmdSetPropertyEditable            Set a property editable flag
  531.  
  532.         kDETcmdDirtyProperty                Dirty a property (notify other code resources of change)
  533.  
  534.         kDETcmdDoPropertyCommand            Issue a property command
  535.  
  536.         kDETcmdAddMenu                        Add to the end of a dynamic menu
  537.         kDETcmdRemoveMenu                    Remove a dynamic menu item
  538.         kDETcmdMenuItemRString                Get a dynamic menu item RString
  539.  
  540.         kDETcmdSaveProperty                    Force a save of a property -- apply all applicable patterns to write out the property
  541.  
  542.         kDETcmdGetCustomViewUserReference    Get custom view user reference (as given in .r file)
  543.         kDETcmdGetCustomViewBounds            Get custom view current bounds
  544.  
  545.         kDETcmdGetResource                    Get a resource from a template
  546. }
  547.  
  548.  
  549. {Values of DETCallBackFunctions }
  550. kDETcmdSimpleCallback = 0;
  551. kDETcmdBeep = 1;
  552. kDETcmdBusy = 2;
  553. kDETcmdChangeCallFors = 3;
  554. kDETcmdGetCommandSelectionCount = 4;
  555. kDETcmdGetCommandItemN = 5;
  556. kDETcmdOpenDSSpec = 6;
  557. kDETcmdAboutToTalk = 7;
  558. kDETcmdUnloadTemplates = 8;
  559. kDETcmdTemplateCounts = 9;
  560.  
  561. kDETcmdTargetedCallback = 1000;
  562. kDETcmdGetDSSpec = 1001;
  563. kDETcmdSublistCount = 1002;
  564. kDETcmdSelectedSublistCount = 1003;
  565. kDETcmdRequestSync = 1004;
  566. kDETcmdBreakAttribute = 1005;
  567. kDETcmdGetTemplateFSSpec = 1006;
  568. kDETcmdGetOpenEdit = 1007;
  569. kDETcmdCloseEdit = 1008;
  570.  
  571. kDETcmdPropertyCallback = 2000;
  572. kDETcmdGetPropertyType = 2001;
  573. kDETcmdGetPropertyNumber = 2002;
  574. kDETcmdGetPropertyRString = 2003;
  575. kDETcmdGetPropertyBinarySize = 2004;
  576. kDETcmdGetPropertyBinary = 2005;
  577. kDETcmdGetPropertyChanged = 2006;
  578. kDETcmdGetPropertyEditable = 2007;
  579. kDETcmdSetPropertyType = 2008;
  580. kDETcmdSetPropertyNumber = 2009;
  581. kDETcmdSetPropertyRString = 2010;
  582. kDETcmdSetPropertyBinary = 2011;
  583. kDETcmdSetPropertyChanged = 2012;
  584. kDETcmdSetPropertyEditable = 2013;
  585. kDETcmdDirtyProperty = 2014;
  586. kDETcmdDoPropertyCommand = 2015;
  587. kDETcmdAddMenu = 2016;
  588. kDETcmdRemoveMenu = 2017;
  589. kDETcmdMenuItemRString = 2018;
  590. kDETcmdSaveProperty = 2019;
  591. kDETcmdGetCustomViewUserReference = 2020;
  592. kDETcmdGetCustomViewBounds = 2021;
  593. kDETcmdGetResource = 2022;
  594.  
  595. kDETcmdHighCallback = $F0000000;        { Force type to be LONGINT }
  596.  
  597. TYPE
  598. DETCallBackFunctions = LONGINT;
  599.  
  600.  
  601. DETCallBackBlockHeader = RECORD
  602.     reqFunction: DETCallBackFunctions;    { Requested function }
  603.     END;
  604.  
  605. DETCallBackBlockTargetedHeader = RECORD
  606.     reqFunction: DETCallBackFunctions;    { Requested function }
  607.     target: DETTargetSpecification;        { The target for the request }
  608.     END;
  609.  
  610. DETCallBackBlockPropertyHeader = RECORD
  611.     reqFunction: DETCallBackFunctions;    { Requested function }
  612.     target: DETTargetSpecification;        { The target for the request }
  613.     property: INTEGER;                    { The property to apply the request to }
  614.     END;
  615.  
  616.  
  617. DETProtoCallBackBlock = DETCallBackBlockPropertyHeader;
  618.     
  619.  
  620. DETBeepBlock = DETCallBackBlockHeader;
  621.  
  622.  
  623. DETBusyBlock = DETCallBackBlockHeader;
  624.  
  625.  
  626. DETChangeCallForsBlock = RECORD
  627.     reqFunction: DETCallBackFunctions;    { Requested function }
  628.     target: DETTargetSpecification;        { The target for the request }
  629.  
  630.     newCallFors: LONGINT;                {  -> New call-for mask }
  631.     END;
  632.  
  633.  
  634. DETGetCommandSelectionCountBlock = RECORD
  635.     reqFunction: DETCallBackFunctions;    { Requested function }
  636.  
  637.     count: LONGINT;                        { <-  The number of items in the command selection list }
  638.     END;
  639.  
  640.  
  641. CONST
  642. {Values of DETItemType }
  643. kDETHFSType = 0;                        { HFS item type }
  644. kDETDSType = 1;                            { Catalog Service item type }
  645. kDETMailType = 2;                        { Mail (letter) item type }
  646. kDETMoverType = 3;                        { Sounds, fonts, etc., from inside a suitcase or system file }
  647. kDETLastItemType = $F0000000;            { Force it to be a LONGINT (C & C++ seem to disagree about the definition of $F000) }
  648.  
  649. TYPE
  650. DETItemType = LONGINT;
  651.  
  652.  
  653.  
  654. DETFSInfo = RECORD                        { FSSpec plus possibly interesting additional info }
  655.     fileType: OSType;                    { File type }
  656.     fileCreator: OSType;                { File creator }
  657.     fdFlags: INTEGER;                    { Finder flags }
  658.     fsSpec: FSSpec;                        { FSSpec }
  659.     END;
  660.  
  661. DETFSInfoPtr = ^DETFSInfo;
  662.  
  663. LetterSpecPtr = ^LetterSpec;
  664. LetterSpecHandle = ^LetterSpecPtr;
  665.  
  666. DETGetCommandItemNBlock = RECORD
  667.     reqFunction: DETCallBackFunctions;    { Requested function }
  668.  
  669.     itemNumber: LONGINT;                {  -> Item number to retrieve (1-based) }
  670.     itemType: DETItemType;                {  -> Type of item to be returned (if we can interpret it as such) }
  671.     CASE INTEGER OF
  672.         1: (fsInfo: ^DETFSInfoPtr);        { <-  FSSpec & info for item (caller must DisposHandle() when done) }
  673.         2: (ds: RECORD
  674.             dsSpec: ^PackedDSSpecPtr;    { <-  DSSpec for item (caller must DisposHandle() when done) }
  675.             refNum: INTEGER;            { <-  Refnum for returned address }
  676.             identity: AuthIdentity;        { <-  Identity for returned address }
  677.             END);
  678.  
  679.         3: (dsSpec: ^PackedDSSpecPtr);    { <-  DSSpec for item (caller must DisposHandle() when done) }
  680.         4: (ltrSpec: LetterSpecHandle);    { <-  Letter spec for item (caller must DisposHandle() when done) }
  681.     END;
  682.  
  683.  
  684. DETGetDSSpecBlock = RECORD
  685.     reqFunction: DETCallBackFunctions;    { Requested function }
  686.     target: DETTargetSpecification;        { The target for the request }
  687.  
  688.     dsSpec: ^PackedDSSpecPtr;            { <-  Handle with result (caller must DisposHandle() when done) }
  689.     refNum: INTEGER;                    { <-  Refnum for address if PD }
  690.     identity: AuthIdentity;                { <-  Identity for address }
  691.     isAlias: BOOLEAN;                    { <-  True if this entry is an alias }
  692.     isRecordRef: BOOLEAN;                { <-  True if this entry is a record reference (reserved) }
  693.     END;
  694.  
  695.  
  696. DETGetTemplateFSSpecBlock = RECORD
  697.     reqFunction: DETCallBackFunctions;    { Requested function }
  698.     target: DETTargetSpecification;        { The target for the request }
  699.  
  700.     fsSpec: FSSpec;                        { <-  FSSpec of template file }
  701.     baseID: INTEGER;                    { <-  Base ID of this template }
  702.     aspectTemplateNumber: LONGINT;        { <-  The template number for this aspect template }
  703.     END;
  704.  
  705. DETGetOpenEditBlock = RECORD
  706.     reqFunction: DETCallBackFunctions;    { Requested function }
  707.     target: DETTargetSpecification;        { The target for the request }
  708.  
  709.     viewProperty: INTEGER;                { <- The property of the view being edited (or kNoProperty if none) }
  710.     END;
  711.  
  712. DETCloseEditBlock = RECORD
  713.     reqFunction: DETCallBackFunctions;    { Requested function }
  714.     target: DETTargetSpecification;        { The target for the request }
  715.  
  716.     END;
  717.  
  718. DETGetPropertyTypeBlock = RECORD
  719.     reqFunction: DETCallBackFunctions;    { Requested function }
  720.     target: DETTargetSpecification;        { The target for the request }
  721.     property: INTEGER;                    { The property to apply the request to }
  722.  
  723.     propertyType: INTEGER;                { <-  The type of the property }
  724.     END;
  725.  
  726.  
  727. DETGetPropertyNumberBlock = RECORD
  728.     reqFunction: DETCallBackFunctions;    { Requested function }
  729.     target: DETTargetSpecification;        { The target for the request }
  730.     property: INTEGER;                    { The property to apply the request to }
  731.  
  732.     propertyValue: LONGINT;                { <-  The value of the property }
  733.     END;
  734.  
  735.  
  736. DETGetPropertyRStringBlock = RECORD
  737.     reqFunction: DETCallBackFunctions;    { Requested function }
  738.     target: DETTargetSpecification;        { The target for the request }
  739.     property: INTEGER;                    { The property to apply the request to }
  740.  
  741.     propertyValue: RStringHandle;        { <-  A handle containing the property (as an RString) (caller must DisposHandle() when done) }
  742.     END;
  743.  
  744.  
  745. DETGetPropertyBinarySizeBlock = RECORD
  746.     reqFunction: DETCallBackFunctions;    { Requested function }
  747.     target: DETTargetSpecification;        { The target for the request }
  748.     property: INTEGER;                    { The property to apply the request to }
  749.  
  750.     propertyBinarySize: LONGINT;        { <-  The size of the property as a binary block }
  751.     END;
  752.  
  753.  
  754. DETGetPropertyBinaryBlock = RECORD
  755.     reqFunction: DETCallBackFunctions;    { Requested function }
  756.     target: DETTargetSpecification;        { The target for the request }
  757.     property: INTEGER;                    { The property to apply the request to }
  758.  
  759.     propertyValue: Handle;                { <-  Handle with the value of the property (caller must DisposHandle() when done) }
  760.     END;
  761.  
  762.  
  763. DETGetPropertyChangedBlock = RECORD
  764.     reqFunction: DETCallBackFunctions;    { Requested function }
  765.     target: DETTargetSpecification;        { The target for the request }
  766.     property: INTEGER;                    { The property to apply the request to }
  767.  
  768.     propertyChanged: BOOLEAN;            { <-  True if the property is marked as changed }
  769.     END;
  770.  
  771.  
  772. DETGetPropertyEditableBlock = RECORD
  773.     reqFunction: DETCallBackFunctions;    { Requested function }
  774.     target: DETTargetSpecification;        { The target for the request }
  775.     property: INTEGER;                    { The property to apply the request to }
  776.  
  777.     propertyEditable: BOOLEAN;            { <-  True if the property can be edited by the user (if false, view will appear disabled) }
  778.     END;
  779.  
  780.  
  781. DETSetPropertyTypeBlock = RECORD
  782.     reqFunction: DETCallBackFunctions;    { Requested function }
  783.     target: DETTargetSpecification;        { The target for the request }
  784.     property: INTEGER;                    { The property to apply the request to }
  785.  
  786.     newType: INTEGER;                    {  -> New type for property (just sets type, does not convert contents) }
  787.     END;
  788.  
  789.  
  790. DETSetPropertyNumberBlock = RECORD
  791.     reqFunction: DETCallBackFunctions;    { Requested function }
  792.     target: DETTargetSpecification;        { The target for the request }
  793.     property: INTEGER;                    { The property to apply the request to }
  794.  
  795.     newValue: LONGINT;                    {  -> New value to set property to (and set type to number) }
  796.     END;
  797.  
  798.  
  799. DETSetPropertyRStringBlock = RECORD
  800.     reqFunction: DETCallBackFunctions;    { Requested function }
  801.     target: DETTargetSpecification;        { The target for the request }
  802.     property: INTEGER;                    { The property to apply the request to }
  803.  
  804.     newValue: RStringPtr;                {  -> New value to set property to (and set type to RString) }
  805.     END;
  806.  
  807.  
  808. DETSetPropertyBinaryBlock = RECORD
  809.     reqFunction: DETCallBackFunctions;    { Requested function }
  810.     target: DETTargetSpecification;        { The target for the request }
  811.     property: INTEGER;                    { The property to apply the request to }
  812.  
  813.     newValue: Ptr;                        {  -> New value to set property to (and set type to binary) }
  814.     newValueSize: LONGINT;                {  -> Size of new value }
  815.     END;
  816.  
  817.  
  818. DETSetPropertyChangedBlock = RECORD
  819.     reqFunction: DETCallBackFunctions;    { Requested function }
  820.     target: DETTargetSpecification;        { The target for the request }
  821.     property: INTEGER;                    { The property to apply the request to }
  822.  
  823.     propertyChanged: BOOLEAN;            {  -> Value to set changed flag on property to }
  824.     END;
  825.  
  826.  
  827. DETSetPropertyEditableBlock = RECORD
  828.     reqFunction: DETCallBackFunctions;    { Requested function }
  829.     target: DETTargetSpecification;        { The target for the request }
  830.     property: INTEGER;                    { The property to apply the request to }
  831.  
  832.     propertyEditable: BOOLEAN;            {  -> Value to set editable flag on property to }
  833.     END;
  834.  
  835.  
  836. DETDirtyPropertyBlock = DETCallBackBlockPropertyHeader;
  837.  
  838.  
  839. DETDoPropertyCommandBlock = RECORD
  840.     reqFunction: DETCallBackFunctions;    { Requested function }
  841.     target: DETTargetSpecification;        { The target for the request }
  842.     property: INTEGER;                    { The property to apply the request to }
  843.  
  844.     parameter: LONGINT;                    { ->  Parameter of command }
  845.     END;
  846.  
  847.  
  848. DETSublistCountBlock = RECORD
  849.     reqFunction: DETCallBackFunctions;    { Requested function }
  850.     target: DETTargetSpecification;        { The target for the request }
  851.  
  852.     count: LONGINT;                        { <-  The number of items in the current item's sublist }
  853.     END;
  854.  
  855.  
  856. DETSelectedSublistCountBlock = RECORD
  857.     reqFunction: DETCallBackFunctions;    { Requested function }
  858.     target: DETTargetSpecification;        { The target for the request }
  859.  
  860.     count: LONGINT;                        { <-  The number of selected items in the current item's sublist }
  861.     END;
  862.  
  863.  
  864. DETRequestSyncBlock =  DETCallBackBlockTargetedHeader;
  865.  
  866.  
  867. DETAddMenuBlock = RECORD
  868.     reqFunction: DETCallBackFunctions;    { Requested function }
  869.     target: DETTargetSpecification;        { The target for the request }
  870.     property: INTEGER;                    { The property to apply the request to }
  871.  
  872.     name: ^RString;                        {  -> Name of new menu item }
  873.     parameter: LONGINT;                    {  -> Parameter to return when this item is selected }
  874.     addAfter: LONGINT;                    {  -> Parameter of entry to add after, or -1 for add at end }
  875.     END;
  876.  
  877.  
  878. DETRemoveMenuBlock = RECORD
  879.     reqFunction: DETCallBackFunctions;    { Requested function }
  880.     target: DETTargetSpecification;        { The target for the request }
  881.     property: INTEGER;                    { The property to apply the request to }
  882.  
  883.     itemToRemove: LONGINT;                {  -> Parameter of menu item to remove }
  884.     END;
  885.  
  886.  
  887. DETMenuItemRStringBlock = RECORD
  888.     reqFunction: DETCallBackFunctions;    { Requested function }
  889.     target: DETTargetSpecification;        { The target for the request }
  890.     property: INTEGER;                    { The property to apply the request to }
  891.  
  892.     itemParameter: LONGINT;                {  -> Parameter of menu item to return string for }
  893.     rString: RStringHandle;                { <-  Handle with the RString (caller must DisposHandle() when done) }
  894.     END;
  895.  
  896.  
  897. DETOpenDSSpecBlock = RECORD
  898.     reqFunction: DETCallBackFunctions;    { Requested function }
  899.  
  900.     dsSpec: PackedDSSpecPtr;            {  -> DSSpec of object to be opened }
  901.     END;
  902.  
  903.  
  904. DETAboutToTalkBlock = DETCallBackBlockHeader;
  905.  
  906.  
  907. DETBreakAttributeBlock = RECORD
  908.     reqFunction: DETCallBackFunctions;    { Requested function }
  909.     target: DETTargetSpecification;        { The target for the request }
  910.  
  911.     breakAttribute: AttributePtr;        {  -> Attribute to parse }
  912.     isChangeable: BOOLEAN;                {  -> True if the value can be changed by the user }
  913.     END;
  914.  
  915.  
  916. DETSavePropertyBlock = DETCallBackBlockPropertyHeader;
  917.  
  918.  
  919. DETGetCustomViewUserReferenceBlock = RECORD
  920.     reqFunction: DETCallBackFunctions;    { Requested function }
  921.     target: DETTargetSpecification;        { The target for the request }
  922.     property: INTEGER;                    { The property to apply the request to }
  923.  
  924.     userReference: INTEGER;                { <-  User reference value, as specified in the .r file }
  925.     END;
  926.  
  927.  
  928. DETGetCustomViewBoundsBlock = RECORD
  929.     reqFunction: DETCallBackFunctions;    { Requested function }
  930.     target: DETTargetSpecification;        { The target for the request }
  931.     property: INTEGER;                    { The property to apply the request to }
  932.  
  933.     bounds: Rect;                        { <-  Bounds of the view }
  934.     END;
  935.  
  936.  
  937. DETGetResourceBlock = RECORD
  938.     reqFunction: DETCallBackFunctions;    { Requested function }
  939.     target: DETTargetSpecification;        { The target for the request }
  940.     property: INTEGER;                    { The property to apply the request to }
  941.  
  942.     resourceType: ResType;                {  -> Resource type }
  943.     theResource: Handle;                { <-  The resource handle (caller must dispose when done) }
  944.     END;
  945.  
  946. DETTemplateCounts = RECORD
  947.     reqFunction: DETCallBackFunctions;    { Requested function }
  948.  
  949.     aspectTemplateCount: LONGINT;        { <-  Number of aspect templates in the system }
  950.     infoPageTemplateCount: LONGINT;        { <-  Number of info-page templates in the system }
  951.     END;
  952.  
  953.  
  954. DETUnloadTemplatesBlock = DETCallBackBlockHeader;
  955.  
  956.  
  957.  
  958. DETCallBackBlock = RECORD
  959.     CASE INTEGER OF
  960.         1: (protoCallBack: DETProtoCallBackBlock);
  961.         2: (beep: DETBeepBlock);
  962.         3: (busy: DETBusyBlock);
  963.         4: (changeCallFors: DETChangeCallForsBlock);
  964.         5: (getCommandSelectionCount: DETGetCommandSelectionCountBlock);
  965.         6: (getCommandItemN: DETGetCommandItemNBlock);
  966.         7: (getDSSpec: DETGetDSSpecBlock);
  967.         8: (getTemplateFSSpec: DETGetTemplateFSSpecBlock);
  968.         9: (getOpenEdit: DETGetOpenEditBlock);
  969.         10: (closeEdit: DETCloseEditBlock);
  970.         11: (getPropertyType: DETGetPropertyTypeBlock);
  971.         12: (getPropertyNumber: DETGetPropertyNumberBlock);
  972.         13: (getPropertyRString: DETGetPropertyRStringBlock);
  973.         14: (getPropertyBinarySize: DETGetPropertyBinarySizeBlock);
  974.         15: (getPropertyBinary: DETGetPropertyBinaryBlock);
  975.         16: (getPropertyChanged: DETGetPropertyChangedBlock);
  976.         17: (getPropertyEditable: DETGetPropertyEditableBlock);
  977.         18: (setPropertyType: DETSetPropertyTypeBlock);
  978.         19: (setPropertyNumber: DETSetPropertyNumberBlock);
  979.         20: (setPropertyRString: DETSetPropertyRStringBlock);
  980.         21: (setPropertyBinary: DETSetPropertyBinaryBlock);
  981.         22: (setPropertyChanged: DETSetPropertyChangedBlock);
  982.         23: (setPropertyEditable: DETSetPropertyEditableBlock);
  983.         24: (dirtyProperty: DETDirtyPropertyBlock);
  984.         25:    (doPropertyCommand: DETDoPropertyCommandBlock);
  985.         26: (sublistCount: DETSublistCountBlock);
  986.         27: (selectedSublistCount: DETSelectedSublistCountBlock);
  987.         28: (requestSync: DETRequestSyncBlock);
  988.         29: (addMenu: DETAddMenuBlock);
  989.         30: (removeMenu: DETRemoveMenuBlock);
  990.         31: (menuItemRString: DETMenuItemRStringBlock);
  991.         32: (openDSSpec: DETOpenDSSpecBlock);
  992.         33: (aboutToTalk: DETAboutToTalkBlock);
  993.         34: (breakAttribute: DETBreakAttributeBlock);
  994.         35: (saveProperty: DETSavePropertyBlock);
  995.         36: (getCustomViewUserReference: DETGetCustomViewUserReferenceBlock);
  996.         37: (getCustomViewBounds: DETGetCustomViewBoundsBlock);
  997.         38: (getResource: DETGetResourceBlock);
  998.         39: (templateCounts: DETTemplateCounts);
  999.         40: (unloadTemplates: DETUnloadTemplatesBlock);
  1000.     END;
  1001.  
  1002. DETCallBackBlockPtr = ^DETCallBackBlock;
  1003.  
  1004.  
  1005. DETCallBack = ProcPtr;
  1006.     { FUNCTION DETCallBack(
  1007.         callBlockPtr: ^DETCallBlock; callBackBlockPtr: DETCallBackBlockPtr): OSErr; }
  1008.  
  1009.  
  1010. { Call functions:
  1011.  
  1012.         reqFunction                        Action
  1013.         -----------                        ------
  1014.         kDETcmdInit                        Called once when template is first loaded (good time to allocate private data); returns call-for list
  1015.         kDETcmdExit                        Called once when template is freed (good time to free private data)
  1016.  
  1017.         kDETcmdAttributeCreation        New sublist attribute creation about to occur; this gives the template a chance to modify
  1018.                                         the value that's about to be created; sent to the template that will be used for
  1019.                                         the main aspect of the new entry
  1020.  
  1021.         kDETcmdDynamicForwarders        Return a list of dynamically created forwarders
  1022.  
  1023.         kDETcmdInstanceInit                Called once when instance of template is started (good time to allocate private instance data)
  1024.         kDETcmdInstanceExit                Called once when instance is ended (good time to free private instance data)
  1025.  
  1026.         kDETcmdIdle                        Called periodically during idle times
  1027.  
  1028.         kDETcmdViewListChanged            Called when the info-page view-list (list of enabled views) has changed
  1029.  
  1030.         kDETcmdValidateSave                Validate save: about to save info-page, return noErr (or kDETDidNotHandle) if it's OK to do so
  1031.  
  1032.         kDETcmdDropQuery                Drop query: return the appropriate operation for this drag; ask destination
  1033.         kDETcmdDropMeQuery                Drop query: return the appropriate operation for this drag; ask dropee
  1034.  
  1035.         kDETcmdAttributeNew                Attribute value new (return kDETDidNotHandle to let normal new processing occur)
  1036.         kDETcmdAttributeChange            Attribute value change (return kDETDidNotHandle to let normal change processing occur)
  1037.         kDETcmdAttributeDelete            Attribute value delete (return kDETDidNotHandle to let normal deletion occur); sent to the
  1038.                                         main aspect of the attribute that's about to be deleted
  1039.         kDETcmdItemNew                    Target item (record or attribute) has just been created
  1040.  
  1041.         kDETcmdOpenSelf                    Self open (return noErr to prevent opening; return kDETDidNotHandle to allow it)
  1042.  
  1043.         kDETcmdDynamicResource            Return a dynamically created resource
  1044.  
  1045.         kDETcmdShouldSync                Check if the code resource wants to force a sync (update data from catalog)
  1046.         kDETcmdDoSync                    Give code resource a chance to sync (read in and break all attributes)
  1047.  
  1048.         kDETcmdPropertyCommand            Command received in the property number range (usually means a button's been pushed)
  1049.  
  1050.         kDETcmdMaximumTextLength        Return maximum size for text form of property
  1051.  
  1052.         kDETcmdPropertyDirtied            Property dirtied, need to redraw
  1053.  
  1054.         kDETcmdPatternIn                Custom pattern element encountered on reading in an attribute
  1055.         kDETcmdPatternOut                Custom pattern element encountered on writing out an attribute
  1056.  
  1057.         kDETcmdConvertToNumber            Convert from template-defined property type to number
  1058.         kDETcmdConvertToRString            Convert from template-defined property type to RString
  1059.         kDETcmdConvertFromNumber        Convert from number to template-defined property type
  1060.         kDETcmdConvertFromRString        Convert from RString to template-defined property type
  1061.  
  1062.         kDETcmdCustomViewDraw            Custom view draw
  1063.         kDETcmdCustomViewMouseDown        Custom view mouse down
  1064.  
  1065.         kDETcmdKeyPress                    Key press (used primarily to filter entry into EditText views)
  1066.         kDETcmdPaste                    Paste (used primarily to filter entry into EditText views)
  1067.  
  1068.         kDETcmdCustomMenuSelected        Custom Catalogs menu selected
  1069.         kDETcmdCustomMenuEnabled        Return whether custom Catalogs menu entry should be enabled
  1070. }
  1071.  
  1072.  
  1073. CONST
  1074. { Values of DETCallFunctions }
  1075. kDETcmdSimpleCall = 0;
  1076. kDETcmdInit = 1;
  1077. kDETcmdExit = 2;
  1078. kDETcmdAttributeCreation = 3;
  1079. kDETcmdDynamicForwarders = 4;
  1080.  
  1081. kDETcmdTargetedCall = 1000;
  1082. kDETcmdInstanceInit = 1001;
  1083. kDETcmdInstanceExit = 1002;
  1084. kDETcmdIdle = 1003;
  1085. kDETcmdViewListChanged = 1004;
  1086. kDETcmdValidateSave = 1005;
  1087. kDETcmdDropQuery = 1006;
  1088. kDETcmdDropMeQuery = 1007;
  1089. kDETcmdAttributeNew = 1008;
  1090. kDETcmdAttributeChange = 1009;
  1091. kDETcmdAttributeDelete = 1010;
  1092. kDETcmdItemNew = 1011;
  1093. kDETcmdOpenSelf = 1012;
  1094. kDETcmdDynamicResource = 1013;
  1095. kDETcmdShouldSync = 1014;
  1096. kDETcmdDoSync = 1015;
  1097.  
  1098. kDETcmdPropertyCall = 2000;
  1099. kDETcmdPropertyCommand = 2001;
  1100. kDETcmdMaximumTextLength = 2002;
  1101. kDETcmdPropertyDirtied = 2003;
  1102. kDETcmdPatternIn = 2004;
  1103. kDETcmdPatternOut = 2005;
  1104. kDETcmdConvertToNumber = 2006;
  1105. kDETcmdConvertToRString = 2007;
  1106. kDETcmdConvertFromNumber = 2008;
  1107. kDETcmdConvertFromRString = 2009;
  1108. kDETcmdCustomViewDraw = 2010;
  1109. kDETcmdCustomViewMouseDown = 2011;
  1110. kDETcmdKeyPress = 2012;
  1111. kDETcmdPaste = 2013;
  1112. kDETcmdCustomMenuSelected = 2014;
  1113. kDETcmdCustomMenuEnabled = 2015;
  1114.  
  1115. kDETcmdHighCall = $F0000000;    { Force the type to be long }
  1116.  
  1117. TYPE
  1118. DETCallFunctions = LONGINT;
  1119.  
  1120.  
  1121. DETCallBlockHeader = RECORD
  1122.     reqFunction: DETCallFunctions;        { Requested function }
  1123.     callBack: DETCallBack;                { Pointer to call-back routine }
  1124.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1125.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1126.                                             common to all invocations of code resource) }
  1127.     END;
  1128.  
  1129. DETCallBlockTargetedHeader = RECORD
  1130.     reqFunction: DETCallFunctions;        { Requested function }
  1131.     callBack: DETCallBack;                { Pointer to call-back routine }
  1132.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1133.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1134.                                             common to all invocations of code resource) }
  1135.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1136.                                             code resource) }
  1137.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1138.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1139.     END;
  1140.     
  1141. DETCallBlockPropertyHeader = RECORD
  1142.     reqFunction: DETCallFunctions;        { Requested function }
  1143.     callBack: DETCallBack;                { Pointer to call-back routine }
  1144.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1145.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1146.                                             common to all invocations of code resource) }
  1147.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1148.                                             code resource) }
  1149.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1150.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1151.     property: INTEGER;                    { The property number the call refers to }
  1152.     END;
  1153.  
  1154. DETProtoCallBlock = DETCallBlockPropertyHeader;
  1155.  
  1156.  
  1157. DETInitBlock = RECORD
  1158.     reqFunction: DETCallFunctions;        { Requested function }
  1159.     callBack: DETCallBack;                { Pointer to call-back routine }
  1160.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1161.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1162.                                             common to all invocations of code resource) }
  1163.  
  1164.     newCallFors: LONGINT;                { <-  New call-for mask }
  1165.     END;
  1166.  
  1167.  
  1168. DETExitBlock = DETCallBlockHeader;
  1169.  
  1170.  
  1171. DETInstanceInitBlock = DETCallBlockTargetedHeader;
  1172.  
  1173.  
  1174. DETInstanceExitBlock = DETCallBlockTargetedHeader;
  1175.  
  1176.  
  1177. DETInstanceIdleBlock = DETCallBlockTargetedHeader;
  1178.  
  1179.  
  1180. DETPropertyCommandBlock = RECORD
  1181.     reqFunction: DETCallFunctions;        { Requested function }
  1182.     callBack: DETCallBack;                { Pointer to call-back routine }
  1183.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1184.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1185.                                             common to all invocations of code resource) }
  1186.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1187.                                             code resource) }
  1188.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1189.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1190.     property: INTEGER;                    { The property number the call refers to }
  1191.  
  1192.     parameter: LONGINT;                    {  -> Parameter of command }
  1193.     END;
  1194.  
  1195.  
  1196. DETMaximumTextLengthBlock = RECORD
  1197.     reqFunction: DETCallFunctions;        { Requested function }
  1198.     callBack: DETCallBack;                { Pointer to call-back routine }
  1199.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1200.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1201.                                             common to all invocations of code resource) }
  1202.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1203.                                             code resource) }
  1204.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1205.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1206.     property: INTEGER;                    { The property number the call refers to }
  1207.  
  1208.     maxSize: LONGINT;                    { <-  Return the maximum number of characters the user can entry when property is edited in an EditText }
  1209.     END;
  1210.  
  1211.  
  1212. DETViewListChangedBlock = DETCallBlockTargetedHeader;
  1213.  
  1214.  
  1215. DETPropertyDirtiedBlock = DETCallBlockPropertyHeader;
  1216.  
  1217.  
  1218. DETValidateSaveBlock = RECORD
  1219.     reqFunction: DETCallFunctions;        { Requested function }
  1220.     callBack: DETCallBack;                { Pointer to call-back routine }
  1221.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1222.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1223.                                             common to all invocations of code resource) }
  1224.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1225.                                             code resource) }
  1226.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1227.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1228.  
  1229.     errorString: RStringHandle;            { <-  Handle with error string if validation fails (callee must allocate handle, DE will DisposHandle() it) }
  1230.     END;
  1231.  
  1232. { Valid commandIDs for DETDropQueryBlock and DETDropMeQueryBlock (in addition to property numbers): }
  1233. CONST
  1234. kDETDoNothing    = 'xxx0';
  1235. kDETMove        = 'move';
  1236. kDETDrag        = 'drag';
  1237. kDETAlias        = 'alis';
  1238.  
  1239. TYPE
  1240. DETDropQueryBlock = RECORD
  1241.     reqFunction: DETCallFunctions;        { Requested function }
  1242.     callBack: DETCallBack;                { Pointer to call-back routine }
  1243.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1244.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1245.                                             common to all invocations of code resource) }
  1246.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1247.                                             code resource) }
  1248.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1249.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1250.  
  1251.     modifiers: INTEGER;                    {  -> Modifiers at drop time (option/control/command/shift keys) }
  1252.     commandID: LONGINT;                    { <-> Command ID (kDETDoNothing, kDETMove, kDETDrag (copy), kDETAlias, or a property number) }
  1253.     destinationType: AttributeType;        { <-> Type to convert attribute to }
  1254.     copyToHFS: BOOLEAN;                    { <-  If true, object should be copied to HFS before being operated on, and deleted after }
  1255.     END;
  1256.  
  1257.  
  1258. DETDropMeQueryBlock = RECORD
  1259.     reqFunction: DETCallFunctions;        { Requested function }
  1260.     callBack: DETCallBack;                { Pointer to call-back routine }
  1261.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1262.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1263.                                             common to all invocations of code resource) }
  1264.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1265.                                             code resource) }
  1266.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1267.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1268.  
  1269.     modifiers: INTEGER;                    {  -> Modifiers at drop time (option/control/command/shift keys) }
  1270.     commandID: LONGINT;                    { <-> Command ID (kDETDoNothing, kDETMove, kDETDrag (copy), kDETAlias, or a property number) }
  1271.     destinationType: AttributeType;        { <-> Type to convert attribute to }
  1272.     copyToHFS: BOOLEAN;                    { <-  If true, object should be copied to HFS before being operated on, and deleted after }
  1273.     END;
  1274.  
  1275.  
  1276. DETAttributeCreationBlock = RECORD
  1277.     reqFunction: DETCallFunctions;        { Requested function }
  1278.     callBack: DETCallBack;                { Pointer to call-back routine }
  1279.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1280.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1281.                                             common to all invocations of code resource) }
  1282.  
  1283.     parent: PackedDSSpecPtr;            {  -> The object within which the creation will occur }
  1284.     refNum: INTEGER;                    {  -> Refnum for returned address (DSSpecs in PDs only) }
  1285.     identity: AuthIdentity;                {  -> The identity we're browsing as in the parent object }
  1286.     attrType: AttributeType;            { <-> The type of the attribute being created }
  1287.     attrTag: AttributeTag;                { <-> The tag of the attribute being created }
  1288.     value: Handle;                        { <-> The value to write (pre-allocated, resize as needed) }
  1289.     END;
  1290.  
  1291.  
  1292. DETAttributeNewBlock = RECORD
  1293.     reqFunction: DETCallFunctions;        { Requested function }
  1294.     callBack: DETCallBack;                { Pointer to call-back routine }
  1295.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1296.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1297.                                             common to all invocations of code resource) }
  1298.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1299.                                             code resource) }
  1300.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1301.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1302.  
  1303.     parent: PackedDSSpecPtr;            {  -> The object within which the creation will occur }
  1304.     refNum: INTEGER;                    {  -> Refnum for returned address (DSSpecs in PDs only) }
  1305.     identity: AuthIdentity;                {  -> The identity we're browsing as in the parent object }
  1306.     attrType: AttributeType;            { <-> The type of the attribute being created }
  1307.     attrTag: AttributeTag;                { <-> The tag of the attribute being created }
  1308.     value: Handle;                        { <-> The value to write (pre-allocated, resize as needed) }
  1309.     END;
  1310.  
  1311.  
  1312. DETAttributeChangeBlock = RECORD
  1313.     reqFunction: DETCallFunctions;        { Requested function }
  1314.     callBack: DETCallBack;                { Pointer to call-back routine }
  1315.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1316.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1317.                                             common to all invocations of code resource) }
  1318.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1319.                                             code resource) }
  1320.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1321.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1322.  
  1323.     parent: PackedDSSpecPtr;            {  -> The object within which the creation will occur }
  1324.     refNum: INTEGER;                    {  -> Refnum for returned address (DSSpecs in PDs only) }
  1325.     identity: AuthIdentity;                {  -> The identity we're browsing as in the parent object }
  1326.     attrType: AttributeType;            { <-> The type of the attribute being changed }
  1327.     attrTag: AttributeTag;                { <-> The tag of the attribute being changed }
  1328.     attrCID: AttributeCreationID;        { <-> The CID of the attribute being changed }
  1329.     value: Handle;                        { <-> The value to write (pre-allocated, resize as needed) }
  1330.     END;
  1331.  
  1332. DETAttributeDeleteBlock = RECORD
  1333.     reqFunction: DETCallFunctions;        { Requested function }
  1334.     callBack: DETCallBack;                { Pointer to call-back routine }
  1335.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1336.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1337.                                             common to all invocations of code resource) }
  1338.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1339.                                             code resource) }
  1340.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1341.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1342.  
  1343.     dsSpec: PackedDSSpecPtr;            {  -> The object which will be deleted }
  1344.     refNum: INTEGER;                    {  -> Refnum for returned address (DSSpecs in PDs only) }
  1345.     identity: AuthIdentity;                {  -> The identity we're browsing as }
  1346.     END;
  1347.  
  1348. DETItemNewBlock = DETCallBlockTargetedHeader;
  1349.  
  1350. DETShouldSyncBlock = RECORD
  1351.     reqFunction: DETCallFunctions;        { Requested function }
  1352.     callBack: DETCallBack;                { Pointer to call-back routine }
  1353.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1354.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1355.                                             common to all invocations of code resource) }
  1356.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1357.                                             code resource) }
  1358.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1359.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1360.  
  1361.     shouldSync: BOOLEAN;                { <-  True if we should now sync with catalog }
  1362.     END;
  1363.  
  1364. DETDoSyncBlock = DETCallBlockTargetedHeader;
  1365.  
  1366. DETPatternInBlock = RECORD
  1367.     reqFunction: DETCallFunctions;        { Requested function }
  1368.     callBack: DETCallBack;                { Pointer to call-back routine }
  1369.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1370.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1371.                                             common to all invocations of code resource) }
  1372.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1373.                                             code resource) }
  1374.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1375.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1376.     property: INTEGER;                    { The property number the call refers to }
  1377.  
  1378.     elementType: LONGINT;                {  -> Element type from pattern }
  1379.     extra: LONGINT;                        {  -> Extra field from pattern }
  1380.     attribute: AttributePtr;            {  -> The complete attribute }
  1381.     dataOffset: LONGINT;                { <-> Offset to current (next) byte }
  1382.     bitOffset: INTEGER;                    { <-> Bit offset (next bit is ^fData >> fBitOffset++) }
  1383.     END;
  1384.  
  1385.  
  1386. DETPatternOutBlock = RECORD
  1387.     reqFunction: DETCallFunctions;        { Requested function }
  1388.     callBack: DETCallBack;                { Pointer to call-back routine }
  1389.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1390.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1391.                                             common to all invocations of code resource) }
  1392.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1393.                                             code resource) }
  1394.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1395.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1396.     property: INTEGER;                    { The property number the call refers to }
  1397.  
  1398.     elementType: LONGINT;                {  -> Element type from pattern }
  1399.     extra: LONGINT;                        {  -> Extra field from pattern }
  1400.     attribute: AttributePtr;            {  -> The attribute (minus the data portion) }
  1401.     data: Handle;                        {  -> Data to be written (pre-allocated, resize and add at end) }
  1402.     dataOffset: LONGINT;                { <-> Offset to next byte to write }
  1403.     bitOffset: INTEGER;                    { <-> Bit offset (if zero, handle will need to be resized to one more byte before write) }
  1404.     END;
  1405.  
  1406.  
  1407. DETOpenSelfBlock = RECORD
  1408.     reqFunction: DETCallFunctions;        { Requested function }
  1409.     callBack: DETCallBack;                { Pointer to call-back routine }
  1410.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1411.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1412.                                             common to all invocations of code resource) }
  1413.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1414.                                             code resource) }
  1415.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1416.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1417.  
  1418.     modifiers: INTEGER;                    { -> Modifiers at open time (option/control/command/shift keys) }
  1419.     END;
  1420.  
  1421.  
  1422. DETConvertToNumberBlock = RECORD
  1423.     reqFunction: DETCallFunctions;        { Requested function }
  1424.     callBack: DETCallBack;                { Pointer to call-back routine }
  1425.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1426.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1427.                                             common to all invocations of code resource) }
  1428.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1429.                                             code resource) }
  1430.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1431.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1432.     property: INTEGER;                    { The property number the call refers to }
  1433.  
  1434.     theValue: LONGINT;                    { <-  The converted value to return }
  1435.     END;
  1436.  
  1437.  
  1438. DETConvertToRStringBlock = RECORD
  1439.     reqFunction: DETCallFunctions;        { Requested function }
  1440.     callBack: DETCallBack;                { Pointer to call-back routine }
  1441.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1442.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1443.                                             common to all invocations of code resource) }
  1444.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1445.                                             code resource) }
  1446.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1447.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1448.     property: INTEGER;                    { The property number the call refers to }
  1449.  
  1450.     theValue: RStringHandle;            { <-  A handle with the converted value (callee must allocate handle, DE will DisposHandle() it) }
  1451.     END;
  1452.  
  1453.  
  1454. DETConvertFromNumberBlock = RECORD
  1455.     reqFunction: DETCallFunctions;        { Requested function }
  1456.     callBack: DETCallBack;                { Pointer to call-back routine }
  1457.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1458.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1459.                                             common to all invocations of code resource) }
  1460.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1461.                                             code resource) }
  1462.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1463.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1464.     property: INTEGER;                    { The property number the call refers to }
  1465.  
  1466.     theValue: LONGINT;                    {  -> The value to convert (result should be written direct to the property) }
  1467.     END;
  1468.  
  1469.  
  1470. DETConvertFromRStringBlock = RECORD
  1471.     reqFunction: DETCallFunctions;        { Requested function }
  1472.     callBack: DETCallBack;                { Pointer to call-back routine }
  1473.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1474.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1475.                                             common to all invocations of code resource) }
  1476.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1477.                                             code resource) }
  1478.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1479.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1480.     property: INTEGER;                    { The property number the call refers to }
  1481.  
  1482.     theValue: RStringPtr;                {  -> The value to convert (result should be written direct to the property) }
  1483.     END;
  1484.  
  1485.  
  1486. DETCustomViewDrawBlock = DETCallBlockPropertyHeader;
  1487.  
  1488.  
  1489. DETCustomViewMouseDownBlock = RECORD
  1490.     reqFunction: DETCallFunctions;        { Requested function }
  1491.     callBack: DETCallBack;                { Pointer to call-back routine }
  1492.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1493.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1494.                                             common to all invocations of code resource) }
  1495.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1496.                                             code resource) }
  1497.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1498.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1499.     property: INTEGER;                    { The property number the call refers to }
  1500.  
  1501.     theEvent: ^EventRecord;                {  -> The original event record of the mouse-down }
  1502.     END;
  1503.  
  1504.  
  1505. DETKeyPressBlock = RECORD
  1506.     reqFunction: DETCallFunctions;        { Requested function }
  1507.     callBack: DETCallBack;                { Pointer to call-back routine }
  1508.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1509.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1510.                                             common to all invocations of code resource) }
  1511.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1512.                                             code resource) }
  1513.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1514.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1515.     property: INTEGER;                    { The property number the call refers to }
  1516.  
  1517.     theEvent: ^EventRecord;                {  -> The original event record of the key-press }
  1518.     END;
  1519.  
  1520.  
  1521. DETPasteBlock = RECORD
  1522.     reqFunction: DETCallFunctions;        { Requested function }
  1523.     callBack: DETCallBack;                { Pointer to call-back routine }
  1524.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1525.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1526.                                             common to all invocations of code resource) }
  1527.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1528.                                             code resource) }
  1529.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1530.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1531.     property: INTEGER;                    { The property number the call refers to }
  1532.  
  1533.     modifiers: INTEGER;                    { -> Modifiers at paste time (option/control/command/shift keys) }
  1534.     END;
  1535.  
  1536. DETCustomMenuSelectedBlock = RECORD
  1537.     reqFunction: DETCallFunctions;        { Requested function }
  1538.     callBack: DETCallBack;                { Pointer to call-back routine }
  1539.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1540.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1541.                                             common to all invocations of code resource) }
  1542.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1543.                                             code resource) }
  1544.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1545.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1546.  
  1547.     menuTableParameter: INTEGER;        {  -> The "property" field from the custom menu table }
  1548.     END;
  1549.  
  1550.  
  1551. DETCustomMenuEnabledBlock = RECORD
  1552.     reqFunction: DETCallFunctions;        { Requested function }
  1553.     callBack: DETCallBack;                { Pointer to call-back routine }
  1554.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1555.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1556.                                             common to all invocations of code resource) }
  1557.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1558.                                             code resource) }
  1559.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1560.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1561.  
  1562.     menuTableParameter: INTEGER;        {  -> The "property" field from the custom menu table }
  1563.     enable: BOOLEAN;                    { <-  Whether to enable the menu item }
  1564.     END;
  1565.  
  1566.  
  1567. DETForwarderListItem = RECORD
  1568.     next: ^DETForwarderListPtr;            { Pointer to next item, or nil }
  1569.     attributeValueTag: AttributeTag;    { Tag of new templates (0 for none) }
  1570.     rstrs: PackedPathName;                { Record type (empty if none), attrbute type (empty if none),
  1571.                                             list of template names to forward to }
  1572.     END;
  1573.  
  1574. DETForwarderListPtr = ^DETForwarderListItem;
  1575. DETForwarderListHandle = ^DETForwarderListPtr;
  1576.  
  1577. DETDynamicForwardersBlock = RECORD
  1578.     reqFunction: DETCallFunctions;        { Requested function }
  1579.     callBack: DETCallBack;                { Pointer to call-back routine }
  1580.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1581.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1582.                                             common to all invocations of code resource) }
  1583.  
  1584.     forwarders: DETForwarderListHandle;    { <-  List of forwaders }
  1585.     END;
  1586.  
  1587.  
  1588. DETDynamicResourceBlock = RECORD
  1589.     reqFunction: DETCallFunctions;        { Requested function }
  1590.     callBack: DETCallBack;                { Pointer to call-back routine }
  1591.     callBackPrivate: LONGINT;            { Private data for the call-back routine }
  1592.     templatePrivate: LONGINT;            { Private storage for use by code resource (stays for life of code resource,
  1593.                                             common to all invocations of code resource) }
  1594.     instancePrivate: LONGINT;            { Private storage for use by code resource (separate for each item using the
  1595.                                             code resource) }
  1596.     target: DETTargetSpecification;        { The target (originator) of the call, for targeted and property calls }
  1597.     targetIsMainAspect: BOOLEAN;        { True if the target is the main aspect (even though it has a non-nil name) }
  1598.  
  1599.     resourceType: ResType;                {  -> The resource type being requested }
  1600.     propertyNumber: INTEGER;            {  -> The property number of the resource being requested }
  1601.     resourceID: INTEGER;                {  -> The resource ID (base ID + property number) of the resource }
  1602.     theResource: Handle;                { <-  The requested resource }
  1603.     END;
  1604.  
  1605.  
  1606.  
  1607. DETCallBlock = RECORD
  1608.     CASE INTEGER OF
  1609.          1: (protoCall: DETProtoCallBlock);
  1610.          2: (init: DETInitBlock);
  1611.          3: (exit: DETExitBlock);
  1612.          4: (instanceInit: DETInstanceInitBlock);
  1613.          5: (instanceExit: DETInstanceExitBlock);
  1614.          6: (instanceIdle: DETInstanceIdleBlock);
  1615.          7: (propertyCommand: DETPropertyCommandBlock);
  1616.          8: (maximumTextLength: DETMaximumTextLengthBlock);
  1617.          9: (viewListChanged: DETViewListChangedBlock);
  1618.         10: (propertyDirtied: DETPropertyDirtiedBlock);
  1619.         11: (validateSave: DETValidateSaveBlock);
  1620.         12: (dropQuery: DETDropQueryBlock);
  1621.         13: (dropMeQuery: DETDropMeQueryBlock);
  1622.         14: (attributeCreationBlock: DETAttributeCreationBlock);
  1623.         15: (attributeNew: DETAttributeNewBlock);
  1624.         16: (attributeChange: DETAttributeChangeBlock);
  1625.         17: (attributeDelete: DETAttributeDeleteBlock);
  1626.         18:    (itemNew: DETItemNewBlock);
  1627.         19: (patternIn: DETPatternInBlock);
  1628.         20: (patternOut: DETPatternOutBlock);
  1629.         21: (shouldSync: DETShouldSyncBlock);
  1630.         22: (doSync: DETDoSyncBlock);
  1631.         23: (openSelf: DETOpenSelfBlock);
  1632.         24: (convertToNumber: DETConvertToNumberBlock);
  1633.         25: (convertToRString: DETConvertToRStringBlock);
  1634.         26: (convertFromNumber: DETConvertFromNumberBlock);
  1635.         27: (convertFromRString: DETConvertFromRStringBlock);
  1636.         28: (customViewDraw: DETCustomViewDrawBlock);
  1637.         29: (customViewMouseDown: DETCustomViewMouseDownBlock);
  1638.         30: (keyPress: DETKeyPressBlock);
  1639.         31: (paste: DETPasteBlock);
  1640.         32: (customMenuSelected: DETCustomMenuSelectedBlock);
  1641.         33: (customMenuEnabled: DETCustomMenuEnabledBlock);
  1642.         34: (dynamicForwarders: DETDynamicForwardersBlock);
  1643.         35: (dynamicResource: DETDynamicResourceBlock);
  1644.     END;
  1645.  
  1646. DETCallBlockPtr = ^DETCallBlock;
  1647.  
  1648. { Call-for list: }
  1649.  
  1650. CONST
  1651. kDETCallForOther            = 1;            { Call for things not listed below (also auto-enabled by DE if any of the below are enabled) }
  1652. kDETCallForIdle                = 2;            { kDETcmdIdle }
  1653. kDETCallForCommands            = 4;            { kDETcmdPropertyCommand, kDETcmdSelfOpen }
  1654. kDETCallForViewChanges        = 8;            { kDETcmdViewListChanged, kDETcmdPropertyDirtied, kDETcmdMaximumTextLength }
  1655. kDETCallForDrops            = $10;            { kDETcmdDropQuery, kDETcmdDropMeQuery }
  1656. kDETCallForAttributes        = $20;            { kDETcmdAttributeCreation, kDETcmdAttributeNew, kDETcmdAttributeChange, kDETcmdAttributeDelete }
  1657. kDETCallForValidation        = $40;            { kDETcmdValidateSave }
  1658. kDETCallForKeyPresses        = $80;            { kDETcmdKeyPress and kDETcmdPaste }
  1659. kDETCallForResources        = $100;            { kDETcmdDynamicResource }
  1660. kDETCallForSyncing            = $200;            { kDETcmdShouldSync, kDETcmdDoSync }
  1661. kDETCallForEscalation        = $8000;        { All calls escalated from the next lower level }
  1662.  
  1663. kDETCallForNothing            = 0;            { None of the above }
  1664. kDETCallForEverything         = $FFFFFFFF;    { All of the above }
  1665.  
  1666. TYPE
  1667. DETCall = ProcPtr;
  1668.     { FUNCTION DETCall(callBlockPtr: DETCallBlockPtr): OSErr; }
  1669.  
  1670.  
  1671. { This following macro saves you from having to dig out the call-back pointer from the call block: }
  1672.  
  1673. { #define CallBackDET(callBlockPtr, callBackBlockPtr) ((*callBlockPtr->protoCall.callBack)(callBlockPtr,callBackBlockPtr)) }
  1674.  
  1675.  
  1676. { ************************************************************************************ }
  1677. { ********************************* SAM Definitions: ********************************* }
  1678. { ************************************************************************************ }
  1679.  
  1680.  
  1681. { SAM Developers should use property numbers starting at this point: }
  1682. CONST
  1683. kSAMFirstDevProperty = kDETFirstDevProperty + 10;
  1684.  
  1685.  
  1686. {
  1687.     SAM templates have additional resources/properties that are required
  1688.     for interaction with the AOCE Key Chain.
  1689.     
  1690.      Type    Offset                        Description
  1691.      ----    ------                        -----------
  1692.     'rstr'    kSAMAspectUserName            The user name
  1693.     'rstr'    kSAMAspectKind                The kind of SAM
  1694.     'detn'    kSAMAspectCannotDelete        If 0, then the slot cannot be deleted
  1695.     'sami'    kSAMAspectSlotCreationInfo    The info required to create a slot record
  1696. }
  1697.  
  1698. CONST
  1699. kSAMAspectUserName            = kDETFirstDevProperty + 1;
  1700. kSAMAspectKind                = kDETFirstDevProperty + 2;
  1701. kSAMAspectCannotDelete        = kDETFirstDevProperty + 3;
  1702. kSAMAspectSlotCreationInfo    = kDETFirstDevProperty + 4;
  1703.  
  1704.  
  1705. { ************************************************************************************** }
  1706. { ********************************* Admin Definitions: ********************************* }
  1707. { ************************************************************************************** }
  1708.  
  1709. kDETAdminVersion    = -978;
  1710.  
  1711. {$ENDC}    { UsingOCETemplates }
  1712.  
  1713. {$IFC NOT UsingIncludes}
  1714.     END.
  1715. {$ENDC}
  1716.